home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / utility / ds_v1.zip / DIRSTAT.DOC next >
Text File  |  1992-10-23  |  20KB  |  488 lines
  1.  
  2.  
  3.             User Instructions for DirStat V1.00 - Revised 10/23/92
  4.  
  5.  
  6.  
  7.     
  8.     
  9.     
  10.     
  11.     =====================================================================
  12.                                 DirStat V1.00
  13.                          FreeWare Utility Program By
  14.                                  Steve Dunn
  15.                               50 Hillside Drive
  16.                              Hanover, MA. 02339
  17.                           CompuServe ID: 70034,2454
  18.     =====================================================================
  19.     
  20.     
  21.     
  22.     DISTRIBUTION:
  23.     ------------
  24.     
  25.     
  26.         DirStat may be freely copied and used by you or anyone you know
  27.     for any and all non-commercial purposes without payment of any fee,
  28.     provided that you distribute BOTH DIRSTAT.EXE and DIRSTAT.DOC
  29.     together without any modifications.
  30.     
  31.         This program remains my personal property, and is explicitly NOT
  32.     being placed in the Public Domain.  It is, instead, "FreeWare".
  33.     
  34.     
  35.     ---------------------------------------------------------------------
  36.     
  37.     
  38.     Legal Disclaimers:
  39.     -----------------
  40.     
  41.     
  42.                    YOU USE THIS SOFTWARE AT YOUR OWN RISK!
  43.     
  44.              UNDER NO CIRCUMSTANCES WILL I BE LIABLE TO YOU FOR
  45.                           ANY DAMAGES OF ANY SORT!
  46.     
  47.                THIS SOFTWARE CARRIES NO WARRANTY OF ANY TYPE,
  48.                 INCLUDING FITNESS FOR ANY PARTICULAR PURPOSE!
  49.     
  50.     
  51.     
  52.         I welcome your feedback, comments, criticisms, etc at any time -
  53.     your best bet is to send CompuServe E:Mail to my ID (70034,2454) or
  54.     hard-copy mail to me at the address on page one of this
  55.     documentation.  Please do not call me on the phone.
  56.  
  57.             User Instructions for DirStat V1.00 - Revised 10/23/92
  58.  
  59.  
  60.  
  61.     Using DirStat
  62.     -------------
  63.     
  64.     
  65.         DirStat is an easy to use utility that groups files in any given
  66.     PATH by file EXTension and provides you with a means of analyzing
  67.     and manipulating such groups of files.
  68.     
  69.     
  70.         DirStat V1.00 is written for a color monitor, and may not be
  71.     entirely useful on monochrome monitors (some color combinations may
  72.     be difficult to read).  If enough people request it, I'll offer a
  73.     future version with the ability to switch between color and
  74.     monochrome display attributes.
  75.     
  76.     
  77.           DirStat V1.00 has an internal limit of 1,560 files per PATH and
  78.     / or subdirectory.  This limit is based on the programs internal
  79.     design, and cannot be altered by the user.  If this presents you with
  80.     a real problems, let me know and I'll see about increasing it.
  81.     (Although why would you want to have so many files in a single
  82.     directory ?!?).
  83.  
  84.             User Instructions for DirStat V1.00 - Revised 10/23/92
  85.  
  86.  
  87.  
  88.     Syntax and Command Line Parms:
  89.     -----------------------------
  90.     
  91.     
  92.         DirStat should be invoked from the DOS command line using the
  93.     following syntax:
  94.     
  95.           DIRSTAT [/?] | [d:][\path\] [/25] [/43] [/50] [CE] [/NC]
  96.     
  97.         All the above command line parms are OPTIONAL, and are defined as
  98.     follows:
  99.     
  100.         /?  - If these characters appear anywhere on your command line,
  101.             DirStat will display a help screen for its syntax similar to
  102.             what appears on this page.
  103.     
  104.         d:  - The DOS DRIVE that you want DirStat to start off reading.
  105.             If you omit this, DirStat will use the current default DOS
  106.             DRIVE.
  107.     
  108.         \path\ - The DOS PATH you want DirStat to start off reading.  If
  109.             you omit this, DirStat will use the current default DOS PATH.
  110.     
  111.                - NOTE: Do NOT include a file specification on the
  112.             command line!  DirStat automatically adds "*.*" at run time.
  113.     
  114.         /25 - tells DirStat to start up in 25-rows-per screen mode.
  115.     
  116.         /43 - tells DirStat to start up in 43-rows-per screen mode.  This
  117.             requires an EGA or better.
  118.     
  119.         /50 - tells DirStat to start up in 50-rows-per screen display
  120.             mode.  This requires an VGA or better.
  121.     
  122.         NOTE:   - You can also alter the number of rows per screen page
  123.                 from within DirStat at any point by using the F9 menu
  124.                 option, which provides a menu of available screen modes.
  125.     
  126.         NOTE:   - If you use more than one of the above, DirStat will
  127.                 pick the largest value for the number of screen rows.
  128.     
  129.         NOTE:   - DirStat will not check to see whether you have the
  130.                 necessary hardware before attempting to set the mode you
  131.                 want.  If you don't have the physical hardware needed,
  132.                 you will get an error message.
  133.     
  134.         /CE - tells DirStat to clear the display screen on exit.
  135.             Normally, DirStat leaves the last screen full of display data
  136.             up when it exits.
  137.     
  138.         /NC - tells DirStat to NOT clear the screen on exit.
  139.  
  140.             User Instructions for DirStat V1.00 - Revised 10/23/92
  141.  
  142.  
  143.  
  144.         Note that the /25, /43, /50, and the /CE parms can also be
  145.     specified in a DOS ENVIRON string using the DOS command, SET, as in
  146.     the following example:
  147.     
  148.     
  149.                              SET DIRSTAT=/CE/43
  150.     
  151.     
  152.         which changes the default behavior of DirStat such that it starts
  153.     up in 43 rows per screen mode, and clears the screen on exit.
  154.     
  155.     
  156.         Note that parms on the DOS command line will OVERRIDE the ENVIRON
  157.     parms at run time, so that you do not need to alter your "DIRSTAT="
  158.     ENVIRON string merely to alter DirStat's default behavior.
  159.     
  160.     
  161.     ---------------------------------------------------------------------
  162.     
  163.     
  164.         DirStat is fully menu driven - the available functions are always
  165.     displayed on the right hand side of the display screen.  The
  166.     following pages will detail what each menu function does.
  167.     
  168.  
  169.             User Instructions for DirStat V1.00 - Revised 10/23/92
  170.  
  171.  
  172.  
  173.     Detailed Instructions:
  174.     ---------------------
  175.     
  176.         After invoking DirStat, a screen similar to the following will
  177.     appear on the screen (the "Summary Data" screen):
  178.  
  179.  
  180.    <*> Dirstat Directory Utility Program V1.00  - FreeWare by Steve Dunn <*>
  181.                               Path: F:\WIN31\*.*
  182. Files:   181  EXTs:    24   Bytes:  8,039,239
  183. EXT       #    Smallest    Biggest      Total    %  ╓─────────────────────────╖
  184. BMP        9      1,630    153,718    744,126   9.3 ║[*] DirStat Main Menu [*]║
  185. GRP        6        810     13,739     34,396   0.4 ╟─────────────────────────╢
  186. HLP       33      5,872    150,877  1,063,669  13.2 ║[F1]  Sort by EXT        ║
  187. PIF       11        545        545      5,995   0.1 ║[F2]  Sort by COUNT      ║
  188. WAV       28      8,546    171,658    960,246  11.9 ║[F3]  Sort by SMALLEST   ║
  189. DAT        6          4     65,536    152,769   1.9 ║[F4]  Sort by BIGGEST    ║
  190. EXE       41      3,744    452,096  4,212,564  52.4 ║[F5]  Sort by TOTAL      ║
  191. INI       15         98      7,810     17,887   0.2 ║[F6]  Sort ASCENDING     ║
  192. MID        1     33,883     33,883     33,883   0.4 ║[F7]  Print data to FILE ║
  193. ICO        1        766        766        766   0.0 ║[F8]  Print data to LPT1 ║
  194. SCR        9      5,328     62,688    178,944   2.2 ║[F9]  Change Screen Rows ║
  195. TRM        1      4,096      4,096      4,096   0.1 ║[F10] Show EXT DETAILS   ║
  196. ION        1      7,752      7,752      7,752   0.1 ╟─────────────────────────╢
  197. DLL        5      6,766    271,264    424,812   5.3 ║[PGUP] Show Prev Page    ║
  198. TXT        2      2,956     41,724     44,680   0.6 ║[PGDN] Show Next Page    ║
  199. WPG        1     11,872     11,872     11,872   0.1 ║[HOME] Show 1st Page     ║
  200. SYS        2      5,873     13,824     19,697   0.2 ║[END]  Show Last Page    ║
  201. L00        1      1,945      1,945      1,945   0.0 ║[INS]  Read new PATH     ║
  202. P00        1      1,945      1,945      1,945   0.0 ║[ESC]  Quit DirStat      ║
  203. COM        2     44,170     56,425    100,595   1.3 ╙─────────────────────────╜
  204.  
  205.     
  206.     
  207.     Line 1: - The program name, version number, and personal plug!
  208.     Line 2: - The DRIVE and PATH currently being displayed.  Note
  209.             that the "*.*" is added automatically for you and should
  210.             NOT be included on the DOS command line.
  211.     Line 3: - Summary data on the DRIVE and PATH hilighted on line 2 -
  212.             Files = total number of files in the DRIVE and PATH,
  213.                     including Hidden, Read-Only, etc files.
  214.             EXTs  = the number of different and unique filename
  215.                     EXTensions found in the DRIVE and PATH.
  216.             Bytes = the total number of bytes in all the files found in
  217.                     the DRIVE and PATH (this is the DOS File size, not
  218.                     the number of bytes in occupied disk clusters).
  219.     
  220.         Directly beneath this header data, on the left hand side of the
  221.     screen, is summary data - one line for each different filename
  222.     .EXTension found.
  223.  
  224.             User Instructions for DirStat V1.00 - Revised 10/23/92
  225.  
  226.  
  227.  
  228.         The leftmost column (EXT) gives each individual EXT name.
  229.     
  230.         The next column (#) gives the number of files found in the DRIVE
  231.         and PATH which have each EXTension.
  232.     
  233.         The next column (Smallest) gives the size, in bytes, of the
  234.         smallest file bearing each individual EXTension.
  235.     
  236.         The next column (Biggest) gives the size, in bytes, of the
  237.         largest file bearing each individual EXTension.
  238.     
  239.         The next column (Total) gives the total number of bytes found in
  240.         all files bearing each individual EXTension.
  241.     
  242.         The last column (%) gives the percentage of bytes in all files of
  243.         each individual EXTension compared to the total number of bytes
  244.         found in ALL files.
  245.     
  246.     
  247.         Note that, originally, this data is unsorted - the EXT names are
  248.     presented in the order in which they are encountered in the DOS
  249.     directory listing.  The menu on the right hand side of the screen
  250.     allows you to re-arrange the summary data into more useful formats,
  251.     as follows:
  252.     
  253.         F6  - Switches SORT order between ascending and descending.
  254.     
  255.         F1  - Sorts the display alphabetically by the EXT name
  256.     
  257.         F2  - Sorts the display numerically by the COUNT (i.e., the
  258.             number of files for each individual EXTension).
  259.     
  260.         F3  - Sorts the display numerically by the size of the smallest
  261.             file found for each individual EXTension.
  262.     
  263.         F4  - Sorts the display numerically by the size of the largest
  264.         file found for each individual EXTension.
  265.     
  266.         F5  - Sorts the display by the total number of bytes for all
  267.             files found for each individual EXTension.
  268.     
  269.         F7  - Sends a copy of the summary data, as it is currently
  270.             sorted, to a disk file (named "SUMMARY.DS1").  This file will
  271.             be located in the DRIVE and PATH as displayed on line 2 of
  272.             the screen.
  273.     
  274.             - If a file named "SUMMARY.DS1" already exists, you will be
  275.             given the option to either OVERWRITE the existing file or to
  276.             append the current data onto the end of the existing disk
  277.             file.
  278.  
  279.             User Instructions for DirStat V1.00 - Revised 10/23/92
  280.  
  281.  
  282.  
  283.         F8  - Sends a copy of the summary data, as it is currently
  284.             sorted, to the printer at LPT1.
  285.     
  286.         F9  - Brings up a menu allowing you to change the number of
  287.             screen rows currently being displayed.  The valid choices are
  288.             25, 43, or 50.
  289.     
  290.             - NOTE: DirStat will NOT check your hardware to see if your
  291.             system physically supports these screen modes.
  292.     
  293.             - NOTE: See also the section above on "Syntax and Command
  294.             Line Parms".
  295.     
  296.     
  297.         F10 - Loads the file details for any EXTension you specify (see
  298.             section below, "Detail Data"
  299.     
  300.         PGUP, PGDN, HOME, END all move you around the display of summary
  301.         data, assuming there is too much of it to fit on the screen at
  302.         one time.
  303.     
  304.         INS - Allows you to specify a different DOS DRIVE and PATH to
  305.             read and work with.
  306.     
  307.         ESC - Exits the DirStat program.
  308.  
  309.             User Instructions for DirStat V1.00 - Revised 10/23/92
  310.  
  311.  
  312.  
  313.     Detail Data:
  314.     ------------
  315.     
  316.         When you press F10 from the DirStat Main Menu, you are asked to
  317.     specify one of the EXTension names shown in the leftmost screen
  318.     display column.
  319.     
  320.         When you do, DirStat loads all the files (from the DRIVE and PATH
  321.     shown on screen line 2), and presents you with a screen similar to
  322.     the following:
  323.     
  324.  
  325.  
  326.    <*> Dirstat Directory Utility Program V1.00  - FreeWare by Steve Dunn <*>
  327.                               Path: F:\WIN31\*.*
  328. Files:   181  EXTs:    24   Bytes:  8,039,239
  329.  --- Filename.EXT        Size     Date      Time ---╓─────────────────────────╖
  330.    1 APPS    .HLP      15,694  03-10-1992  03:10    ║   [*] DETAIL Menu [*]   ║
  331.    2 BIOGRAF .HLP      27,946  08-12-1992  01:01    ╟─────────────────────────╢
  332.    3 CALC    .HLP      18,076  03-10-1992  03:10    ║[F1]  Sort by NAME       ║
  333.    4 CALENDAR.HLP      20,656  03-10-1992  03:10    ║[F2]  Sort by SIZE       ║
  334.    5 CARDFILE.HLP      24,810  03-10-1992  03:10    ║[F3]  Sort by DATE       ║
  335.    6 CHARMAP .HLP      10,797  03-10-1992  03:10    ║[F4]  Shell to LIST      ║
  336.    7 CLIPBRD .HLP      13,071  03-10-1992  03:10    ║[F5]  DELETE a File      ║
  337.    8 CONTROL .HLP     121,672  03-10-1992  03:10    ║[F6]  Sort ASCENDING     ║
  338.    9 GLOSSARY.HLP      46,570  03-10-1992  03:10    ║[F7]  Print data to FILE ║
  339.   10 HOTSPOT .HLP       9,978  04-02-1992  22:18    ║[F8]  Print data to LPT1 ║
  340.   11 MORECON .HLP       5,872  05-16-1992  17:04    ║[F9]  Change Screen Rows ║
  341.   12 MPLAYER .HLP      12,896  03-10-1992  03:10    ║[F10] EXIT DirStat       ║
  342.   13 NOTEPAD .HLP      13,894  03-10-1992  03:10    ╟─────────────────────────╢
  343.   14 PACKAGER.HLP      21,156  03-10-1992  03:10    ║[PGUP] Show Prev Page    ║
  344.   15 PBRUSH  .HLP      40,269  03-10-1992  03:10    ║[PGDN] Show Next Page    ║
  345.   16 PIFEDIT .HLP      33,270  03-10-1992  03:10    ║[HOME] Show 1st Page     ║
  346.   17 POINT   .HLP      39,542  03-10-1992  08:20    ║[END]  Show Last Page    ║
  347.   18 PRINTMAN.HLP      40,880  03-10-1992  03:10    ╟─────────────────────────╢
  348.   19 PROGMAN .HLP      30,911  03-10-1992  03:10    ║[ESC]  Back to Main Menu ║
  349.   20 PSP     .HLP     150,877  03-09-1992  08:05    ╙─────────────────────────╜
  350.  
  351.  
  352.     
  353.     
  354.     Line 1: - The program name, version number, and personal plug!
  355.     Line 2: - The DRIVE and PATH currently being displayed.  Note
  356.             that the "*.*" is added automatically for you and should
  357.             NOT be included on the DOS command line.
  358.     Line 3: - Summary data on the DRIVE and PATH hilighted on line 2 -
  359.             Files = total number of files in the DRIVE and PATH,
  360.                     including Hidden, Read-Only, etc files.
  361.             EXTs  = the number of different and unique filename
  362.                     EXTensions found in the DRIVE and PATH.
  363.             Bytes = the total number of bytes in all the files found in
  364.                     the DRIVE and PATH (this is the DOS File size, not
  365.                     the number of bytes in occupied disk clusters).
  366.  
  367.             User Instructions for DirStat V1.00 - Revised 10/23/92
  368.  
  369.  
  370.  
  371.         Directly beneath this screen header data, on the lefthand side
  372.     of the display screen, is a list of each file matching the EXTension
  373.     name you originally specified, defined as follows:
  374.     
  375.     
  376.         The leftmost column contains an identifier number used by DirStat
  377.         (which also allows you to see exactly where you are on the
  378.         display of detailed data).
  379.     
  380.         The next column (Filename.EXT) contains the full filename and
  381.         EXTension, as it would appear in DOS DIR lists.  Note that all
  382.         the EXTensions will be identical (naturally).
  383.     
  384.         The next column (Size) displays the number of bytes in each file
  385.         (again, the DOS file size, not the amount in occupied clusters)
  386.         formatted for easier reading.
  387.     
  388.         The next column (Date) contains the DOS file date (the date on
  389.         which the file was last affected).
  390.     
  391.         The final column (Time) contains the DOS file time (the time at
  392.         which the file was last affected).
  393.     
  394.     
  395.         Note that, originally, this data is unsorted - the EXT names are
  396.     presented in the order in which they are encountered in the DOS
  397.     directory listing.  The menu on the right hand side of the screen
  398.     allows you to re-arrange the detailed data into more useful formats,
  399.     as follows:
  400.     
  401.         F6  - Switches SORT order between ascending and descending.
  402.     
  403.         F1  - Sorts the display alphabetically by filename
  404.     
  405.         F2  - Sorts the display numerically by file size in bytes.
  406.     
  407.         F3  - Sorts the display by the DOS file date.
  408.     
  409.         F4  - Shells to DOS, invoking a command named "LIST" and passing
  410.         to it the DOS DRIVE, PATH, and FILENAME.EXT (you are first asked
  411.         to specify a particular file by entering its "number" from the
  412.         leftmost column).
  413.             - This is supposed to allow you to view the contents of a
  414.         specific file, and ASSUMES you have an appropriate file viewing
  415.         utility program named "LIST".  DirStat does not provide any file
  416.         viewing capabilities of its own.
  417.  
  418.             User Instructions for DirStat V1.00 - Revised 10/23/92
  419.  
  420.  
  421.  
  422.         F5  - Deletes a file you specify by giving its "number" from the
  423.         leftmost column.
  424.     
  425.         - NOTE: - If you enter a "9999" here, DirStat will delete ALL
  426.                 FILES CURRENTLY DISPLAYED, AND WILL RETURN YOU TO THE
  427.                 SUMMARY DATA SCREEN (which will be adjusted to reflect
  428.                 the changes you just made).
  429.                 - CAUTION: DirStat will delete HIDDEN and READ ONLY files
  430.                 along with any other type file it finds.
  431.     
  432.         F7  - Prints the display data, as it is currently sorted, to a
  433.         disk file in the DRIVE and PATH on screen line 2 named
  434.         "???FILES.DS1", where the three ?'s are replaced by the EXTension
  435.         name you are currently viewing.
  436.             - If a file already exists with the same name and EXTension,
  437.         DirStat will give you the option of either OVERWRITING the
  438.         existing file, or merely APPENDING the current display data to
  439.         the existing file
  440.     
  441.         F8  - Sends a listing of the display data, as it is currently
  442.         sorted, to the printer at LPT1.
  443.     
  444.         F9  - Brings up a menu allowing you to change the number of
  445.             screen rows currently being displayed.  The valid choices are
  446.             25, 43, or 50.
  447.     
  448.             - NOTE: DirStat will NOT check your hardware to see if your
  449.             system physically supports these screen modes.
  450.     
  451.             - NOTE: See also the section above on "Syntax and Command
  452.             Line Parms".
  453.     
  454.     
  455.         F10 - Exit the DirStat program.
  456.     
  457.         PGUP, PGDN, HOME, END all move you around the display of detail
  458.         data, assuming there is too much of it to fit on the screen at
  459.         one time.
  460.     
  461.         ESC - Takes you back to the Summary Data display screen.
  462.  
  463.             User Instructions for DirStat V1.00 - Revised 10/23/92
  464.  
  465.  
  466.  
  467.     Version History:
  468.     ---------------
  469.     
  470.         Version 1.00 was originally released to the public on 10/23/92.     
  471.     
  472.     
  473.     
  474.     
  475.     New Versions:
  476.     ------------
  477.     
  478.         New versions are uploaded originally to CompuServe IBMSYS forum,
  479.     Library 5, and to "CHANNEL 1" BBS in Boston, MA.
  480.     
  481.     
  482.     
  483.     
  484.     What next:
  485.     ---------
  486.     
  487.         What features would YOU like to see in future versions of
  488.     DirStat?